Chapter 3 - Page Formatting and Dialog Box Customization
This chapter describes how your application can manipulate the objects that QuickDraw GX uses to format the pages of a document or add panels to QuickDraw GX dialog boxes.Read the information in this chapter if you want your application to allow users to specify unique formats for the individual pages of a printable document. For example, using QuickDraw GX, your application can allow a user to create and print a single document that consists of an address page on an envelope, a business letter on a sheet of paper in portrait orientation, and a spreadsheet on a sheet of paper in landscape orientation.
You should also read this chapter if you want to add panels to QuickDraw GX print dialog boxes. For example, your application may add a panel that allows the user to specify additional information, such as color-separation for color printing.
Before you begin using QuickDraw GX page formatting and dialog box customization features, you should be familiar with the basic concepts for printing with QuickDraw GX, as described in the chapter, "Introduction to Printing With QuickDraw GX." You should also be familiar with creating and manipulating a job object, as described in the chapter "Core Printing Features" in this book.
This chapter begins by summarizing what you need to know to support the page formatting and dialog box customization features of QuickDraw GX. Because page formatting and dialog box customization can use collection objects, this topic is introduced first. Page formatting is discussed next because you can use collection items as parameters to specify formatting criteria. Dialog box customization is discussed after the other two topics because you may need to use nondefault dialog boxes to allow the user to set the values of items in a collection object. Keep in mind that any QuickDraw GX print dialog box can be customized, not just the Custom Page Setup dialog box associated with page formatting.
After introducing the basic concepts associated with printing-related collection objects, page formatting, and dialog box customization, this chapter shows you how to
- access an item in a collection object for use with a dialog box
- keep track of format objects that are shared by multiple pages of a document
- create a format object for a page in a document
- clone a format object for multiple pages in a document
- dispose of a format object for a page in a document
- access information associated with a format object
- display the Custom Page Setup dialog box
- support special formatting features
- associate format objects with document pages
- add panels to QuickDraw GX dialog boxes
- automate panel information
Chapter Contents
- About Page Formatting and Dialog Box Customization
- About Collection Objects
- Collection Tag IDs and Item IDs
- Item Structures
- Categories of Collection Items
- The Job Collection
- The Format Collection
- The Paper-Type Collection
- About Page Formatting
- Manipulating Format Objects
- Mapping for Format Objects
- Forms and Format Objects
- Halftones and Format Collections
- Dialog Box Customization
- The Dialog Box Panel Resource
- Responding to Panel Events
- Automating Panel Events
- Using Printing-Related Collection Objects
- Accessing Data From a Collection Object
- Using a Collection to Implement the Print One Copy Menu Item
- Replacing Items in Collections
- Specifying Page Ranges in the Job Collection
- Using Format Objects and Collection Items to Format Pages
- Creating a Format Object for a Page in a Document
- Sharing Formats for Document Pages
- Disposing of a Format Object for a Page in a Document
- Using Forms With Format Objects
- Storing Halftone Information in a Format Collection
- Copying a Format Object for Use in Other Documents
- Obtaining the Mapping From a Format Object
- Obtaining a Paper-Type Object Associated With a Format
- Scanning Through a Job's Format Objects
- Associating Format Objects With Document Pages
- Customizing QuickDraw GX Dialog Boxes
- Adding Panels to Dialog Boxes
- Setting Up Dialog Box Resources
- Parsing Page Ranges
- Page Formatting and Dialog Box Customization Reference
- Constants for Loop Status Information
- Constants for Collection Item Categories and Tag IDs
- Collection Item Categories
- Collection Tag ID
- Constants and Data Types for Job Collection Items
- Print-Job Information
- Collation Information
- Copies Information
- Page-Range Information
- Quality Information
- File-Destination Information
- File-Location Information
- File-Format Information
- File-Fonts Information
- Paper-Feed Information
- Manual-Feed Information
- Standard Mapping Information
- Special Mapping Information
- Tray-Mapping Information
- Print-Panel Information
- Format-Panel Information
- Paper-Mapping Information
- Translated-Document Information
- Constants and Data Types for Format Collection Items
- Orientation Information
- Scaling Information
- Direct-Mode Information
- Format-Halftone Information
- Page-Inversion Information
- Horizontal Page-Flip Information
- Vertical Page-Flip Information
- Precise-Bitmap Information
- Paper-Type Lock Information
- Constants and Data Types for Paper-Type Collection Items
- Base Information
- Creator Information
- Units Information
- Flags Information
- Comment Information
- Panel-Related Constants and Data Types
- The Panel Information Structure
- Panel Events
- Panel Responses
- Panel Event Actions
- The Panel Setup Structure
- Printing Panel Kinds
- Parse Range Results
- Functions
- Creating and Manipulating Format Objects
- Manipulating Format Object Properties
- Displaying the Custom Page Setup Dialog Box
- Working With Panels
- Accessing Printing-Related Collection Objects
- Application-Defined Functions
- Message Override Functions for Customizing QuickDraw GX Dialog Boxes
- Looping Through Format Objects
- Dialog Box-Related Resources
- The Panel Resource
- The Extended Item List Resource
- Summary of Page Formatting and Dialog Box Customization
- Constants and Data Types
- Constants for Loop Status Information
- Constants for Collection Item Categories and Tag IDs
- Collection Item Categories
- Collection Tag ID
- Constants and Data Types for Job Collection Items
- Print-Job Information
- Collation Information
- Copies Information
- Page-Range Information
- Quality Information
- File-Destination Information
- File-Location Information
- File-Format Information
- File-Fonts Information
- Paper-Feed Information
- Manual-Feed Information
- Standard Mapping Information
- Special Mapping Information
- Tray-Mapping Information
- Print-Panel Information
- Format-Panel Information
- Paper-Mapping Information
- Translated-Document Information
- Constants and Data Types for Format Collection Items
- Orientation Information
- Scaling Information
- Direct-Mode Information
- Format-Halftone Information
- Page-Inversion Information
- Horizontal Page-Flip Information
- Vertical Page-Flip Information
- Precise-Bitmap Information
- Paper-Type Lock Information
- Constants and Data Types for Paper-Type Collection Items
- Base Information
- Creator Information
- Units Information
- Flags Information
- Comment Information
- Panel-Related Constants and Data Types
- QuickDraw GX Dialog Box Panel Information
- The Panel Information Structure
- Panel Events
- Panel Responses
- Panel Event Actions
- The Panel Setup Structure
- Printing Panel Kinds
- Parse Range Results
- Functions
- Creating and Manipulating Format Objects
- Manipulating Format Object Properties
- Displaying the Custom Page Setup Dialog Box
- Working With Panels
- Accessing Printing-Related Collection Objects
- Application-Defined Functions
- Message Override Functions for Customizing Dialog Boxes
- Looping Through Format Objects
- Dialog Box-Related Resources
- The Panel Resource
- The Extended Item List Resource
Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help